home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 49 / Amiga Format CD49 (2000-01-17)(Future Publishing)(GB)(Track 1 of 3)[!][issue 2000-02].iso / -serious- / workbench / processicon / processicon.readme < prev    next >
Text File  |  1999-11-30  |  6KB  |  129 lines
  1. Short:    V1.16 CLI tool to manipulate icon data
  2. Uploader: stoecker@amigaworld.com (Dirk Stoecker)
  3. Author:   stoecker@amigaworld.com (Dirk Stoecker)
  4. Type:     util/wb
  5. Version:  1.16
  6. Kurz:     CLI Programm zum Aendern von Icon-Daten
  7.  
  8. ProcessIcon needs OS 37 (2.0) or later OS versions!
  9.  
  10. Usage:
  11.   ProcessIcon ICON/A,REFICON,VIEW/S,OPT=OPTIMIZE/S,US=UNSNAP/S,REMAP/S
  12.   NI2CI/S,MWB2CI/S,II2CI/S,MAKECI/S,
  13.  
  14.   SBP=SETBITPLANES/N,SDT=SETDEFTOOL,SIT=SETICONTYPE,SSS=SETSTACKSIZE/N,
  15.   ST1=SETTRANSPARENT1/N,ST2=SETTRANSPARENT2/N,SXP=SETXPOS/N,SYP=SETYPOS/N,
  16.   
  17.   KCI=KILLCOLORICON/S,KDD=KILLDRAWERDATA/S,KDT=KILLDEFTOOL/S,
  18.   KII=KILLICONIMAGE/S,KNI=KILLNEWICON/S,KSS=KILLSTACKSIZE/S,
  19.   KTT=KILLTOOLTYPES/S,
  20.   
  21.   CDD=COPYDRAWERDATA/S,CDT=COPYDEFTOOL/S,CII=COPYICONIMAGE/S,
  22.   CIT=COPYICONTYPE/S,CNI=COPYNEWICON/S,CSS=COPYSTACKSIZE/S,
  23.   CTT=COPYTOOLTYPES/S:
  24.  
  25. A lot of options :-) When you need some more, please contact me. It is
  26. most time really easy to implement them!
  27.  
  28. ICON    The icon you want to manipulate. When it does not exist, it is
  29.         created (works only, when at least a drawer or file of that name
  30.         exists.).
  31. REFICON Reference icon for copy options.
  32. VIEW    Show some information about ICON. Any other options are disabled by
  33.         this one.
  34. OPT     Remove useless stuff in ICON (f.e. DrawerData for Project-Icons).
  35. UNSNAP  Removes position information of ICON. This can be done with
  36.         Workbench menu as well.
  37. REMAP    Switches fore- and background color when only 1 bitplane or
  38.     color 2 and 3 (black and white) for 2 and more bitplanes. This is
  39.     to support those old OS1.3 style icons still appearing sometimes.
  40.  
  41. NI2CI    Converts NewIcon images to OS3.5 icon data.
  42. MWB2CI    Converts MagicWB icons to OS3.5 icons with correct palette.
  43. II2CI    Convert standard icons to OS3.5 icon data. Useful for later
  44.     modification.
  45. MAKECI    This equals II2CI for old style icons and "NI2CI KNI" for new icons.
  46.     For icons with NewIcon and OS3.5 data it means "KNI". It is useful
  47.     to add KII and OPT keyword to reduce size.
  48.  
  49. SBP     Set number of bitplanes. Reducing number of bitplanes may make older
  50.         icons look better.
  51. SDT     Set default tool of ICON.
  52. SIT     Set type of ICON. Allowed types are: "Disk", "Drawer", "Tool",
  53.         "Project", "Garbage", "Device", "Kick" and "AppIcon".
  54. SSS    Set the stack size to any value.
  55. ST1    Set transparent color 1 of OS3.5 data (-1 == no transparency)
  56. ST2    Set transparent color 2 of OS3.5 data (-1 == no transparency)
  57. SXP     Set left position of ICON.
  58. SYP     Set upper position of ICON.
  59.  
  60. KCI    Kills OS3.5 color icon data.
  61. KDD     Kill DrawerData in ICON. This does delete drawer data for tool and
  62.         project icons. For drawers and disks the data is not deleted, but
  63.         replaced by default data.
  64. KDT     Delete default tool in ICON.
  65. KII    Replace icon image with that 5x5 box used by NewIcons. This option
  66.     also sets bitplanes to 3, so you cannot use SBP option.
  67. KNI    Delete NewIcon images from ICON.
  68. KSS     Set Stacksize in ICON to 0 (this is default and used as size 4096).
  69. KTT     Remove ToolTypes from ICON, but leave NewIcon image intact.
  70.  
  71. CCI    Copy OS3.5 color icon data from REFICON to ICON.
  72. CDD     Copy DrawerData from REFICON to ICON. This size, position and view
  73.         state of a drawer window (not of the icon). Only useful for
  74.         drawers.
  75. CDT     Copy default tool from REFICON to ICON. Only useful for Project
  76.         icons.
  77. CII    Copy the image (or maybe two images) from REFICON to ICON. This
  78.         also affects the icon position. The position is changed in a way,
  79.         so that the icon text appears at same position as before.
  80. CIT    Copy the icon type from REFICON to ICON.
  81. CNI    Copy NewIcon image from REFICON to ICON.
  82. CSS    Copy Stacksize form REFICON to ICON.
  83. CTT     Copy ToolTypes from REFICON to ICON (but ignore NewIcon image stuff).
  84.  
  85. Beginning with version 1.13 the program no longer treats NewIcon data as
  86. ToolTypes! CTT and KTT only affect the tooltypes and CNI and KNI only
  87. affect the NewIcon image data (which are in real tooltypes as well).
  88. Since version 1.14 OS3.5 icons are handled correctly.
  89.  
  90. Some notes:
  91.   Starting with OS3.5, stacksizes below 4096 are always raised to value 4096.
  92.   This also affects KSS-Option.
  93.  
  94.   If the copy arguments are used and there is no such data in REFICON, the
  95.   argument equals the function of kill arguments (replace by nothing).
  96.  
  97.   If an icon contains both NewIcon and OS3.5 stuff, after modifications the
  98.   OS3.5 stuff disappears.
  99.  
  100.   All the CI options need OS3.5 running.
  101.  
  102. ! Using this tool with OS3.5 icons without running OS3.5 destroys the color
  103. ! image information of the icons. Also OS3.5 icons cannot be detected without
  104. ! running OS 3.5.
  105.  
  106. I myself use option CII to replace various text, guide or drawer icons with
  107. my default icons without losing icon positions and DrawerData. This is done
  108. by a click on a DirWork button. (For DirOpus users it should be easy as
  109. well).
  110.  
  111. Please report me bugs, comments, suggestions and problems. If possible
  112. write a little mail if you use the program sometimes. If there are some
  113. Enforcer hits or other problems report them as good as possible.
  114.  
  115. Use it as you want, but WITHOUT ANY WARRANTY!
  116.  
  117. Please contact me:
  118.  
  119. ************************************************************************
  120. * snail-mail:                  * e-mail:                               *
  121. *   Dirk Stoecker              *   stoecker@amigaworld.com             *
  122. *   Geschwister-Scholl-Str. 10 *   dstoecker@gmx.de                    *
  123. *   01877 Bischofswerda        * world wide web:                       *
  124. *   GERMANY                    *   http://home.pages.de/~Gremlin/      *
  125. * phone:                       * pgp key:                              *
  126. *   GERMANY +49 (0)3594/706666 *   get with finger or from WWW pages   *
  127. ************************************************************************
  128.  
  129.